package com.manage.common.result;

import com.fasterxml.jackson.annotation.JsonInclude;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Getter;
import lombok.Setter;

import java.io.Serializable;

/**
 * 全局响应结果封装类
 * 统一前后端交互的JSON格式，包含状态码、消息、数据三部分
 *
 * @param <T> 响应数据的类型
 */
@Getter
@Setter
@JsonInclude(JsonInclude.Include.NON_NULL) // 序列化时忽略null字段，减少响应更简洁
@Schema(description = "统一响应结果封装")
public class Result<T> implements Serializable {

    @Schema(description = "响应状态码（200=成功，4xx=客户端错误，5xx=服务器错误）", example = "200")
    private int code;

    /**
     * 响应消息（成功/错误描述）
     */
    @Schema(description = "响应消息（成功或错误描述）", example = "操作成功")
    private String message;

    /**
     * 响应数据（成功时返回，失败时可为null）
     */
    @Schema(description = "响应数据（成功时返回，失败时可能为null）")
    private T data;


    // ====================== 状态码常量（参考HTTP状态码规范设计） ======================
    /** 成功 */
    public static final int SUCCESS = 200;
    /** 参数错误（客户端输入错误） */
    public static final int PARAM_ERROR = 400;
    /** 未授权（未登录或token失效） */
    public static final int UNAUTHORIZED = 401;
    /** 权限不足（已访问权限） */
    public static final int FORBIDDEN = 403;
    /** 资源不存在 */
    public static final int NOT_FOUND = 404;
    /** 服务器错误（服务器内部错误） */
    public static final int SYSTEM_ERROR = 500;


    // ====================== 私有构造方法（私有，强制通过静态方法创建实例） ======================
    public Result() {}

    public Result(int code, String message, T data) {
        this.code = code;
        this.message = message;
        this.data = data;
    }


    // ====================== 成功响应（重载方法，覆盖不同场景） ======================

    /**
     * 成功响应（无数据）
     */
    public static <T> Result<T> success() {
        return new Result<>(SUCCESS, "操作成功", null);
    }

    /**
     * 成功响应（带数据）
     * @param data 响应数据
     */
    public static <T> Result<T> success(T data) {
        return new Result<>(SUCCESS, "操作成功", data);
    }

    /**
     * 成功响应（自定义消息+数据）
     * @param message 自定义成功消息
     * @param data 响应数据
     */
    public static <T> Result<T> success(String message, T data) {
        return new Result<>(SUCCESS, message, data);
    }


    // ====================== 失败响应（重载方法，覆盖常见错误场景） ======================

    /**
     * 失败响应（默认服务器错误）
     */
    public static <T> Result<T> fail() {
        return new Result<>(SYSTEM_ERROR, "服务器内部错误", null);
    }

    /**
     * 失败响应（自定义错误消息，默认服务器错误码）
     * @param message 错误描述
     */
    public static <T> Result<T> fail(String message) {
        return new Result<>(SYSTEM_ERROR, message, null);
    }

    /**
     * 失败响应（自定义错误码+消息）
     * @param code 错误状态码（建议使用类中定义的常量）
     * @param message 错误描述
     */
    public static <T> Result<T> fail(int code, String message) {
        return new Result<>(code, message, null);
    }

    /**
     * 失败响应（通过异常生成，自动获取异常消息）
     * @param e 异常对象（自动提取message作为错误描述）
     */
    public static <T> Result<T> fail(Throwable e) {
        return new Result<>(SYSTEM_ERROR, e.getMessage(), null);
    }


    // ====================== 链式调用（方便动态设置属性） ======================

    /**
     * 设置状态码（链式调用）
     */
    public Result<T> setCode(int code) {
        this.code = code;
        return this;
    }

    /**
     * 设置消息（链式调用）
     */
    public Result<T> setMessage(String message) {
        this.message = message;
        return this;
    }

    /**
     * 设置数据（链式调用）
     */
    public Result<T> setData(T data) {
        this.data = data;
        return this;
    }


    // ====================== 工具方法（判断响应是否成功） ======================

    /**
     * 判断响应是否成功
     * @return true=成功，false=失败
     */
    public boolean isSuccess() {
        return this.code == SUCCESS;
    }
}